Next Steps to Merge

API Change Check

APIView identified API level changes in this PR and created the following API reviews

@CodeJourneys could you wait for us to further confirm if there's any more additional preview features being added into the stable version? @kazrael2119 could provide further investigation result.

Sorry for my mistake of introducing breaking changes when doing typespec conversion.
@mcgallan and I have double confirmed the differences between origin swagger and the generated swagger.
There's no additional properties being added into the stable version.

@CodeJourneys Operation Registries_Create added a new example reference with RegistryCreateAbac when doing typespec conversion,

In your old swagger, you added this example under examples in https://github.com/Azure/azure-rest-api-specs/pull/37748/files#diff-1c5bbd1e385981c6e7dca82ccac27d4b7e9c82b870021f822693adebe0b11567 but didn't add this reference in the swagger file. Do you have any concerns about this?

@CodeJourneys Operation Registries_Create added a new example reference with RegistryCreateAbac when doing typespec conversion,

In your old swagger, you added this example under examples in https://github.com/Azure/azure-rest-api-specs/pull/37748/files#diff-1c5bbd1e385981c6e7dca82ccac27d4b7e9c82b870021f822693adebe0b11567 but didn't add this reference in the swagger file. Do you have any concerns about this?

Thanks for the review @kazrael2119 and no worries about the miss. It's a good learning for all of us. I'm not sure I understand your question about the example file RegistryCreateAbac.json. Could you clarify a bit?

As far as I understand, in the PR to release 2025-11-01 stable, there was an orphaned examples file RegistryCreateAbac.json, which was present, but ⁠not referenced in the API swagger json, as shown here. However, in the latest version of the 2025-11-01 swagger, it is ⁠referenced as an example for Registries_Create (put). This reference was added in one of the Typespec conversion PRs, as shown here.

Are you asking whether adding the reference as an example is okay, rather than intentionally leaving it orphaned? I'm not aware of any reason we would ever want an orphaned example, but perhaps I'm missing something. cc: @lizMSFT in case I may be missing context on the RegistryCreateAbac example specifically

@kazrael2119 Thanks for catching this! We do need this example for Registries_Create:

          "RegistryCreateAbac": {
            "$ref": "./examples/RegistryCreateAbac.json"
          }

I missed including this example in the Swagger file previously

@mcgallan told me that we have some description diff in 2025-06-01-preview during typespec conversion:
1: description inArchiveVersions_Creat
old: Creates a archive for a container registry with the specified parameters.
new: Creates a archive version for a container registry with the specified parameters.

2: description in ArchiveVersionProperties:
old: The properties of an export pipeline.
new: The properties of an archive version.

Do you have any concerns about these description diff?